home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / ee_030.zip / ENGINE.DOC < prev    next >
Text File  |  1991-07-04  |  34KB  |  874 lines
  1.        ▄▄▄▄▄▄▄▄▄ <Last updated 7/4/91> 0.30 *release* documentation
  2.        ██
  3.        ██         ▄▄▄▄▄▄  █    █  ▄▄▄▄▄▄   ▄▄▄▄▄▄▄▄     ▄▄     ▄   ▄
  4.        ██▄▄▄▄▄▄▄  █       █    █  █    █    █  █  █   ▄▀  ▀▄   █   █
  5.        ██         █       ██████  █    █    █  █  █   █▄▄▄▄█   █   █
  6.        ██         █       █    █  █    █    █  █  █   █    █   █   █
  7.        ██▄▄▄▄▄▄▄  █▄▄▄▄▄  █    █  █▄▄▄▄█    █  █  █   █    █   █   █▄▄▄▄
  8.  
  9.  
  10.                    ▄▄▄▄▄▄▄▄▄
  11.                    ██
  12.                    ██         ▄▄▄▄▄  ▄▄▄▄▄▄  ▄  ▄▄▄▄▄  ▄▄▄▄▄▄
  13.                    ██▄▄▄▄▄▄▄   █  █  █       █   █  █  █
  14.                    ██          █  █  █  ▄▄▄  █   █  █  █▄▄▄
  15.                    ██          █  █  █    █  █   █  █  █
  16.                    ██▄▄▄▄▄▄▄   █  █  █▄▄▄▄█  █   █  █  █▄▄▄▄▄
  17.  
  18.                   ■  By Joe Jared of 1:103/200@Fidonet.org  ■
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. Contents:
  29.  
  30. CONFIGEE.EXE  ---  Compiles Raw text files to Database configuration.
  31.  
  32. EEPACKER.EXE  ---  Compresses Outbound mail using various packers as
  33.                    Defined, or using routing information.
  34.  
  35. EESERA.EXE    ---  Scanner from Hudson to FTSC packets. <ALPHAKEY req'd>
  36.  
  37. EE.EXE        ---  The String that binds all of the utilities together.
  38.                    This utilities reacts to situations on the fly as
  39.                    they occur, to allow as fluent a flow of traffic as
  40.                    possible.  It's capabilities are far in excess of a
  41.                    simple batch file, in that it checks your system for
  42.                    various circumstances that dos cannot, and reacts
  43.                    according to what results it finds.
  44.  
  45. EEMOVER.EXE   ---  For multinode systems.  This program enables multiple
  46.                    working outbound directories for Binkley systems,
  47.                    without the need of .BSY flags in the least.  It is a
  48.                    secondary processor, that focuses on sharing
  49.                    violations, and is designed to operate in conjunction
  50.                    with EEPACKER in the shell environment.
  51.  
  52.  
  53. FloMover.EXE  --- For multinode Binkley systems only.
  54.                   This program is used to move the stray flo files that
  55.                   are created by various utilities to the multinode
  56.                   outbound directory that is shared by 2 or more lines.
  57.                   It does not use nor does it need the .bsy flags in
  58.                   Binkley v 2.40 or later, but requires that share be
  59.                   loaded to handle file sharing violations.  If a file
  60.                   listed in the flo file is not marked for deletion or
  61.                   truncation, it is marked as read only, to assure that
  62.                   if it is to be distributed on multinode systems
  63.                   concurrently, that no file sharing violations occur.
  64.  
  65. PKTTOOUT.EXE  ---  For rebuilding of outbound directories.  This program
  66.                    will rename all .pkt files in the specified directory
  67.                    and then call EE PACK to repackage them.
  68.  
  69. SENDDIFF.EXE  ---  This utility is used to aid in the distribution of
  70.                    nodediffs of various flavors.  It will create various
  71.                    flavors of nodediffs, and allow you to script just
  72.                    who gets what compression method.
  73.  
  74. Description:
  75.  
  76.         Echomail engine is a fidonet technology Net/Echomail processor,
  77.         designed specificly for the hudson and future related
  78.         structures.  Also included is a generic Shell environment, to
  79.         improve the process you already have with your current mail
  80.         processor.  This shell environment is expandable to your needs,
  81.         and in addition, will react on the fly to changes in netmail,
  82.         badmsgs, drive space, and other problems as addressed in
  83.         EE_Support.  The goal for the shell environment is 0 downtime.
  84.  
  85. Limitations:
  86.  
  87.         Echomail Engine has the following limitations:
  88.  
  89.         Up to 64000 bytes of text space in each message processed.
  90.         <FTSC does not define a limitation, and messages generated in
  91.         excess of this size will NOT be processed by this program.>
  92.  
  93.         Up to 30 AKA Addresses in EE.cfg
  94.  
  95.         Up to 255 node definitions in EE.CFG for echomail distribution.
  96.  
  97.         Up to 1000 Nodes in routing information.  A Global definition is
  98.            considered One node entry. <Refer to Routing>
  99.  
  100.         Up to 2000 conferences in Areas.bbs
  101.  
  102.         Up to 60000 node entries in Areas.bbs
  103.         255 characters per line in Areas.bbs
  104.  
  105.  
  106.         Up to a total of 10 packers and primary outbound directories.
  107.  
  108. Configuring Echomail Engine:
  109.  
  110.         There are 2 files that Echomail Engine uses.
  111.  
  112. -------------------------------------------------------------------------
  113.         EE.CFG    Configuration information
  114.  
  115.  
  116. Keywords:
  117.  
  118. Debug_ON
  119.         This statement turns debug information on, allowing you to watch
  120.         the config file as it's compiled, to aid in searching for
  121.         problem areas in your config file.
  122.  
  123. Debug_OFF
  124.  
  125.         This statement turns off debug information.
  126.  
  127. Ext_Tosser
  128.         This statement is a keyword that means that you are not using
  129.         Echomail Engine to Toss incoming mail, and have no need for the
  130.         duplicate index.  Each entry in the duplicate index occupies 8k
  131.         of drive space, and accounts for 2000 messages per conference.
  132.  
  133. Sysop Joe Jared
  134.  
  135.         This statement is for netmail and registration purposes.  When
  136.         netmail is received to Sysop at any of your aka addresses,
  137.         it is automatically remapped to the name as defined,
  138.         to make sure that you receive all mailaddressed to you.
  139.         It is also used in the registration information,
  140.         and is not case sensitive.
  141.  
  142.  
  143.  
  144. Serial_No 91-0001
  145.  
  146.         This line should only be used if you've received a registration
  147.         key.  If you haven't, do not use this line.  It will immediately
  148.         abort if this line is found and the key information is not
  149.         found.
  150.  
  151. Address  1:103/201.0
  152. Address  8:911/301.0
  153. Address 144:144/1.0
  154.  
  155.         Up to 30 addresses can be defined
  156.         This is a full 4d address, and your primary address should be
  157.         first.  The primary address should always be the first listed
  158.         address.  The first listed address is used in generating a
  159.         operating key.
  160.         Note: Multiple Addresses in the same ZONE will do nothing more
  161.         than add the number into the SEEN-BY's.
  162.         The first number of each respected Zone is Always used in sending,
  163.         but mail to other AKA's will be accepted.
  164.  
  165.  
  166. Pointnet 10200
  167.  
  168.         This number is used as the fakenet address for mail addressed to
  169.         points.  Any mail addressed to points on your system will
  170.         automatically be remapped to the correct point by creating a
  171.         packet of Pointnet/point.  Also, for normal distribution of
  172.         echomail, the fakenet/point will be included in your point's
  173.         mail only.  Normal traffic to nodes will not have this
  174.         information.
  175.  
  176.  
  177.  
  178. Key   123456789
  179.  
  180.         This information should only be included if you've registered
  181.         the product.  Having this information in place without
  182.         registering the product will cause a failure.
  183.  
  184.  
  185.  
  186. RA_Msg_Dir L:\FD
  187.  
  188.         This is where your hudson type message base should be found.
  189.  
  190. NetMail_Bd 14
  191.  
  192.         This is the board number of where your netmail will be imported
  193.         to/exported from.
  194.  
  195. Netmail         f:\line1\mail1
  196.  
  197.         This is where all file attach messages can be found.
  198.         NOTE:  When routing netmail, Echomail Engine imports the mail
  199.         to other systems, and later exports it into packet format.
  200.         Routed netmail never hits your netmail directory.
  201.  
  202. Netfile         j:\line1\Inb1
  203. KnownFile       J:\Line1\Inb1
  204. SecureFile      J:\Line1\Inp1
  205.  
  206.         Standard Inbound directories used in Binkley
  207.         *** Front Door/D'Bridge systems only use NetFile ***
  208.  
  209.         This is where Echomail Engine expects to find Compressed and
  210.         uncompressed packets for processing.
  211.  
  212.  
  213. Status_Log      EE.CFG
  214.  
  215.         Optionally, a log file can be generated, to allow you to see the
  216.         kind of traffic that is going through your system. The next
  217.         keyword will explain in detail the levels of logging that can be
  218.         done. Status_Log must be defined, to operate properly.  If
  219.         undefined, it will not create a log file at all.
  220.  
  221. <This segment did not make it into 0.30 >
  222. <->
  223. LogLevel        65535
  224.  
  225.         This statement sets an internal group of flags < 16 bits>, to
  226.         allow you to save information of mail processed.  Each Bit will
  227.         activate a single part of the logging to disk that you desire.
  228.         The bits are as followed, and for each level defined, add the
  229.         numeric value to suit your individual needs.
  230.  
  231.         Bit     value   Discription
  232.         0       1       Log all mail exported from your message base.
  233.         1       2       Verbose log of exported mail. <Who/From/Subject>
  234.         2       4       Log the number of messages sent to each node.
  235.         3       8
  236.         4       16
  237.         5       32
  238.         6       64
  239.         7       128
  240.         8       256     Log packet header information of inbound packets.
  241.         9       512     Summarize at each packet.
  242.         10      1024    Verbose log of routed netmail thru your system.
  243.         11      2048
  244.         12      4096
  245.         13      8192
  246.         14      16384
  247.         15      32768   Log All packing and routing occurances.
  248. <->
  249.  
  250.  
  251. Defined_Zones 1 2 3 4 5 6 144
  252.     |
  253.     |   This line is used to determine whether or not EE should place an
  254.     |   outbound file in a properly pathed directory, or to place the
  255.     |   outbound packet in the bad_Zone directory.  adding Zones to this
  256.     |   line will automaticly create the proper directories for
  257.     |   operation, as long as the zones are between 1 & 4095.
  258.     v
  259. BAD_ZONE        l:\outbound\badZone
  260.  
  261.         This is the directory where mail generated to other zones that
  262.         do not have a holding directory are kept.  Typically, you'll
  263.         find netmail here, because directories will be automatically
  264.         created as needed.  The filenames of packets found in this
  265.         directory will be as follows:
  266.                 aaaabbbb.zzz
  267.  
  268.         aaaa = Net <hex>
  269.         bbbb = Node <hex>
  270.         zzz  = Zone <hex>
  271.           All characters to the left are '0' padded.
  272.  
  273.           Example: 9:103/103 = 00670067.009
  274.  
  275.  
  276. Outbound        l:\Outbound\out   <Do not give this directory an
  277.                                   extention>
  278.  
  279.         Your Primary outbound directory.
  280.  
  281.         Note:  This software does support multiple outbound directories,
  282.         in Conjunction with EEMover and MoveMail.exe.  Each of these
  283.         programs handle a specific feature, to better improve speed and
  284.         performance.  Multiple outbounds are only supported for binkley
  285.         at this time, but in the future, other mailers will be supported
  286.         as time allows.  <Refer to packers for details.>
  287.  
  288.         The following example describes the definitions of how outbound
  289.         directories are calculated:
  290.  
  291.         Primary system address = L:\Outbound\Out
  292.         OtherZone matrix mail outbound = L:\Outbound\out.hhh
  293.         hhh = the Destination Zone address <3 digits hex, 0 padded>
  294.         Example: Zone 144  = L:\outbound\Out.090
  295.  
  296.         There is no longer a need to 'calculate' and create these
  297.         directories, as Configee.exe does this for you.
  298.         <Refer to Defined_Zones.>
  299.  
  300.  
  301. DupeFile_path    j:\line1
  302.  
  303.         Note:  This is the directory where EE_Dupes.dat & EE_Dupes.idx will
  304.         reside.  EE_Dupes.Idx will be imported into Areas.Dat, which is
  305.         later discussed in this manual.  Areas.Dat is 8192 bytes per
  306.         conference added, and should remain constant in size once all
  307.         areas have been added.  If this line is not defined, the files
  308.         will be created in the root directory of the drive you are
  309.         operating in.
  310.  
  311. Dupes           f:\Line1\mail1
  312.  
  313.         This is the directory where dupes will be kept in the FTS-0001
  314.         format of a stored message.
  315.  
  316. Max_Pkt_Toss
  317.         Maximum ammount of packets in total bytes that will be processed
  318.         in a single pass of your tosser.
  319.  
  320.  
  321. Max_Packets 10000000 12
  322.  
  323.         Maximum ammount of packets per number of hours it processes mail.
  324.    This feature is designed to limit the overflow that comes from having an
  325.    uplink who's been down for days, thus shutting your system down.
  326.    Only use this feature if you have problems.  Default should be sufficient
  327.    protection for downlinks...
  328.  
  329. MAX_ARCSIZE 500000
  330.  
  331.         The maximum size allowable to add to the same arcmail bag.  If
  332.     the destination mailbag is already over that size, it will increment
  333.     to the next higher archive sequence.  Default is 100000 bytes.
  334.  
  335. Mailer 0 Binkley
  336. Mailer 10 FrontDoor 1.99c
  337. Mailer 11 FrontDoor 2.xx? <Reserved for future implementations>
  338.  
  339.         The type of front end mailer you are using.  All mailers that
  340.         support flags in MSG attach systems use Mailer 10, as that
  341.         application uses ^AFlags to Truncate the file when sent.
  342.  
  343.         Anything other than 0 or 10 will default to Binkley mode
  344.         at this time, so please handle this with care.
  345.  
  346.  
  347. Sizer_Cmd    Sizemail.exe
  348.  
  349.         This program will be called prior to packing archives, and is
  350.         reserved for a pre-processor prior to archiving mailbags.
  351.  
  352.         Note:  Internally EEPacker and EEMover both support sizing of
  353.         arcmail bags, but you may chose to use an external sizing
  354.         program.  If you do, set MAX_ARCSIZE to an ungodly number
  355.         totally unaccessable by a single run of your process.  Default
  356.         for both the mover and packer is 100k.
  357.  
  358.  
  359. Unpacker_CMD Spaz.com -d %N *.pkt
  360.  
  361.         This command will be executed in place of the internal
  362.         de-compressor, for future compatibility issues.
  363.  
  364.         %N is a fully qualified path name, and if the program is not in
  365.         the current directory, it will need to be fully pathed.
  366.  
  367.         If Unpacker_Cmd is commented out, it will recognise on its own
  368.         the existance of the following file compression programs:
  369.         Arc<PKPAK 3.61 and prior and SEA/ARC V6.02>,
  370.         ARJ <2.00 & prior>,
  371.         No-Gate's PAK < 2.52 and prior>
  372.         LHA <2.12 and prior>,
  373.         and PKZip <1.10 and prior>.
  374.  
  375.         The following are example implementations of each compression
  376.         method, using _direct_ calls to the decompressor programs.
  377.  
  378. ARC_Unpack   F:\Arc\PKUnpak.EXE %N *.PKT %D
  379. ARJ_Unpack   f:\ARC\ARJ.EXE e %N *.PKT %D
  380. PAK_Unpack   F:\Arc\PAK.EXE E %N *.pkt %D
  381. LHA_Unpack   f:\Arc\LHA.EXE %N *.PKT %D
  382. ZIP_Unpack   F:\Arc\PKUnzip.exe %N *.PKT %D
  383.  
  384.  
  385. Scanner_Cmd EESERA.EXE SCAN
  386.  
  387. Scanner_Cmd  QM.EXE Scan Pack -z
  388.  
  389.         These command lines tell Echomail engine what processor to use
  390.         in scanning of echo and netmail from your bbs to outbound
  391.         packets.  If you are using a hudson format message base, it will
  392.         only be called if Echomail.bbs exists in the current directory
  393.         in TossScanPack mode, and will be unconditionally be called in
  394.         ScanPack or Scan mode.  Other systems that do not support
  395.         quickindex files will be called unconditionally in all modes.
  396.         Note:  If you are not using any engine utilities for tossing or
  397.         scanning of echomail, add the following line to inhibit the
  398.         creation of dupe files used with Echomail Engine into EE.CFG
  399.  
  400.         Ext_Tosser <Inhibits creation of EE's Dupe files.>
  401.  
  402. Tosser_Cmd  QM.exe Toss scan -q -z
  403.  
  404.         Tosser_CMD EESERA.EXE TOSS SCAN
  405.         This command allows you to run a program other than Echomail Engine
  406.         To import mail. It is called in as many passes as required to
  407.         complete you import/parse process.
  408.  
  409. Mover_CMD           EEMover.EXE
  410.  
  411.         For multinode use only:  This program is called after all mail
  412.         in the primary outbound directory is processed.  Generally, it's
  413.         used to packup all outbound mail in other directories.  If you
  414.         are running a single node system, do not use this program, as it
  415.         will slow your process down.
  416.  
  417.  
  418. OutPAcker_CMD     EEPacker.EXE
  419.  
  420.         This statement is called to packup all outbound mailbags to
  421.         archived format.  What ever program you use should also create
  422.         the appropriate attach format.
  423.  
  424. <The following segment is not fully implemented in release 0.30>
  425. At this time it will call Areafix after all Echomail has been processed
  426. if defined to do so.
  427.  
  428. <->
  429. Areafix_Cmd         Areafix.exe EC
  430.  
  431.         This program will be called at the end of the current process,
  432.         but only if the following circumstances occur:
  433.  
  434.         1> Netmail high message number increases after toss.
  435.         2> BadMessage directory HImsg number increases.
  436. <->
  437.  
  438. NetPacker_CMD       QM.EXE Pack
  439.  
  440. Packers              ( Up to 10)
  441.  
  442.  
  443. Pack ARC f:\ARC\PKpak.exe -oct -m %N %P %D
  444. Pack LHA F:\ARC\LHA.EXE m /x /m %N %P %D
  445. Pack PAK f:\ARC\PAK.EXE M %N %P %D
  446. Pack Zip f:\ARC\PkZip.exe -ex -a -m %N %P %D
  447.  
  448.         These Are Pre-defined PAckers, and must be defined before
  449.         defining Nodes.  Parameters are as follows:
  450.  
  451.         %N = Fully Qualified archive name to be sent
  452.         %P is the packet name after renaming it to FTS packet name.
  453.         %D will employ a direct call to the packer, without calling
  454.         a dos shell.  Make sure that your compressor program is not
  455.         in the current directory, or it may have adverse effects.
  456.         Also, use suggested formats.
  457.  
  458.         The packer MUST be configured to delete the packet after compression,
  459.         and The above examples will work as advertised. Errorlevel returns are
  460.         ignored, and the fact that the packet dissappears is used to
  461.         determine whether or not the compression is successful.
  462.  
  463.         For routing purposes, all mail to undefined Zones will default route
  464.         using OLD COMPRESSION TECHNIQUE.  Be sure to unpack and repack their
  465.         Outbound files before changing packers!
  466.         THE SAMPLES DO WORK.
  467.  
  468.         The following kludge is a multiline kludge.
  469.         The existance of the %M in the line signifies that the destination path
  470.         is where the file will be renamed to.  This path must be on the
  471.         same drive as your primary outbound directory.
  472.         After each pack sequence if a MOVER_CMD is defined, that program is
  473.         executed, to compress the moved mail.
  474.  
  475. Pack MOVER j:\line2\out2 %M
  476.  
  477.         Pack MOVER j:\line2\out2 %M
  478.  
  479.         This keyword simply means to rename the file to a packet,
  480.         And generate a list file in the appropriate flavor,  using
  481.         The following Parameters:
  482.  
  483.         %M is a *flag* to move the file, and *NOT* a program execution!
  484.         The first word following the destination path, is a remap parameter.
  485.         This feature does not work in any environment other than Binkley and
  486.         Other oMMM bundling environments.  This feature *only* works when
  487.         The destination is the same physical drive.
  488.  
  489.         Sequence for this kludge is as follows:
  490.  
  491.         Verb Type   Dest_Path    Trigger_flag
  492.         Pack MOVER j:\line2\out2 %M
  493.         Other strings can be made available as needed
  494.  
  495.         Note:  .BSY flags are not required for this move, and are not
  496.         useful in all applications.  Standard practice in multinode
  497.         environments is to load SHARE <A dos utility> before loading
  498.         any multitasker or File server software.  EEPACKER performs the
  499.         packing of outbound files, and routing.  In the case of
  500.         multinode systems, EEMOVER will finish the job by checking to
  501.         see if the flo file for the destination system can be hidden,
  502.         and if so, it proceeds to pack mail for that node.
  503.  
  504. ------------------------------------------------------------------------
  505. AreasFile 103-200.Lst
  506.  
  507.         AreasFile Echomail parsing information
  508.  
  509.         These files are compiled into database format when ever the date
  510.         stamps of either has changed, and during this process, it will
  511.         point out problem areas in your configuration, in either
  512.         'WARNING', or 'FATAL ERROR' mode.  If a warning has occured, it
  513.         will continue processing, and allow echo/netmail processing to
  514.         continue.  If a fatal error has occured, it will abort
  515.         compilation of the database files, and beep signifying that it
  516.         has an error.
  517.  
  518.  
  519.         -----------------------------------------------------------------
  520.         Note:  Before a system can be sent echomail, that system must be
  521.         qualified via the '@ Zone:Net/Node FLAVOR PACKER' in EE.CFG.
  522.         Failure to do this will result in not adding them to the database.
  523.         -----------------------------------------------------------------
  524.  
  525.         This is the name of the control file for use in parsing of
  526.         incoming echomail. It can be fully qualified file name.
  527.         If this line is not defined, the default will be AREAS.BBS
  528.  
  529.         The structure of the file is as follows:
  530.  
  531. First word      : Board number, P, or # as the first letter of the first
  532.                   word.
  533.  
  534. Second word     : Conference Areaname
  535.  
  536. Remainder of the line : The nodes you feed, in long or short, or tiny form.
  537.  
  538.         Example Long form listing:
  539.  
  540. 1 ORANGE_CO 1:103/100 1:103/350 1:103/201
  541.  
  542.         Short form listing.
  543.  
  544. 1 ORANGE_CO 1:103/100 201 350
  545. 1 ORANGE_CO 103/100 201 350
  546.  
  547.         Also, tiny form is available by the design structure, but
  548.         not recommended for utilities like Areafix, unless they are
  549.         specificly stated to work using this method.
  550.  
  551. 1 ORANGE_CO 100 201 350
  552.  
  553.         The first entry, if no net number is defined, will go to MYNET/.
  554.  
  555.  
  556.         In all entries, 103/100 is listed as the feed for the
  557.         conference, it is imported into Board 1 of RA, and sent on to
  558.         103/201 and 103/350.  For point operation, use the fakenet
  559.         address.  Example: To add .1 to this conference, using the
  560.         fakenet address of 10200, you would then have a areas line that
  561.         looks like this:
  562.  
  563. 1 ORANGE_CO 1:103/100 201 350 10200/1
  564.  
  565.         In this listing, 103/200.1 is now listed in the distribution for
  566.         ORANGE_CO.  Most importantly, your points should have in their
  567.         control file point to your primary address. Example:
  568.  
  569. 1 ORANGE_CO 103/200
  570.  
  571.  
  572. Message_Type RA
  573.  
  574.         The type of Database you are using for your bbs.
  575.  
  576.         Acceptable format's will at some future date will be:
  577.  
  578.         NEWMaximus <Non .msg format>
  579.         PCBOARD
  580.         TELEGARD
  581.         WILDCAT
  582.  
  583.  
  584. NODES
  585.  
  586.         This section is where your downlinks and uplinks are defined.
  587.         This section defines the compression method to be used, as well
  588.         as the flavor of routing.  Sysop name is optional, and will be
  589.         used in all file attach messages for echomail distribution when
  590.         used with Message attach systems, like Front Door and D'Bridge.
  591.  
  592.         However, I do suggest that you enter the sysop's names, because
  593.         you may not be pleased with the default. <grin>
  594.  
  595.  
  596. Any time the @ Symbol is found as the first word of a line, it assumes
  597. you are defining a node entry.  These entries can exist anywhere in the
  598. file.
  599.  
  600. Syntax
  601. @ Zone:Net/Node Flavor Compressor optional_Flags
  602.  
  603. Allowable optional flags:
  604.  
  605. %O - Use old Arcmail extention for this node. <Opus 1.03 and prior>
  606.      This flag forces the file extention to start with MO with the last
  607.      digit being a number from 0 to 9.  Most systems support a higher
  608.      convention than this, so this is considered a non-standard
  609.      compressed naming convention.
  610.  
  611.      The default naming convention of arcmail is to use the first 2
  612.      letters of the week the mail was compressed, with a number to
  613.      signify which mailbag of the day is being created.
  614.  
  615. %E - Extend the arcmail extention to include all of the letters of the
  616.      alphabet except T.  <T confuses Binkley>.  This flag in particular
  617.      helps to better control the size of the archived mailbags, by
  618.      allowing the extentions to go as high as ??Z for a potential of 35
  619.      different arcmailbags per node before cycling back to 0.
  620.      However, some software on other systems do not support this feature,
  621.      so use it carefully.
  622.  
  623.      Do not use this feature on ANY version of OPUS as of this date,
  624.      without permission of the sysop you are feeding.
  625.  
  626. Examples:
  627.  
  628. @ 1:103/100 Crash ZIP
  629.  
  630.         This line tells the packer to Pack all mail with PKZip, and to
  631.         send it crash.
  632.  
  633.  
  634. @ 1:103/102 Crash ZIP
  635. @ 1:103/105 Crash ZIP
  636. @ 1:103/200 Crash ZIP Joe Jared
  637.  
  638. @ 1:103/208 Hold  ARC
  639.  
  640.         This command tells the packer to pack with PKPAK, and send with
  641.         the hold attribute set.
  642.  
  643.         @ 1:103/241 Crash ZIP The Kestral
  644.  
  645.         This command tells the packer to send crash ZIPmail, and to
  646.         address the attach to 'The Kestral'.
  647.         <This feature is not in Release 0.30>
  648.  
  649. @ 143/302 Hold MOVER
  650.  
  651.         By the defination I previously showed for MOVER, all mail to an
  652.         address using a %Multinode move will not really be packed by the
  653.         packer, but rather moved for later processing.  This process is
  654.         very fast, so don't blink, or you'll miss what happened.  If
  655.         your system beeps at you, immediately look in your status_log
  656.         file.  It will return the results of the failure to you.
  657.  
  658.  
  659. @ 69:1000/7 Normal Sir DEP
  660.  
  661.         This line basicly allows your routing section to take priority,
  662. instead of defaulting to crash or hold.
  663.  
  664.  
  665. Routing <Routing information> <Limit 1000 nodes>
  666.  
  667. Before I go into the explaination of this specific section, I'd like to
  668. Explain the limitation involved here.
  669.  
  670.         When you're setting up routing of mail, consider the order with
  671. which you are routing.  This route section is a *sequential* routing
  672. scheme, meaning that the first statement that meets the qualifications for
  673. packing mail to a specific address will hold true.  Make sure you have
  674. default definitions for your own net, Zone, and the other 6 zones.  The
  675. definition of a node entry as it relates to the limitation of the
  676. Routing.Dat file can be calculated as the number of entries whether global
  677. or defined.
  678.  
  679. Example:
  680.  
  681.  
  682. Route Crash 1:103/100 102 103 104 2:all 1:102/all
  683.  
  684. This line is considered 5 nodes towards the limitation.
  685.  
  686.      In the routing.dat, 5 nodes will be defined in the routing file.
  687.  
  688.      1:103/102
  689.      1:103/103
  690.      1:103/104
  691.      2:32767/32767
  692.      1:102/32767
  693.  
  694.  
  695.      65535 is an unused addressing scheme, and is a key number that defines
  696. All mail in that particular Zone or net by default gets sent to the defined
  697. address.  For Routing of netmail, the destination node for the routed mail
  698. need not be defined unless you would like to send anything other than the
  699. default compression method, or uncompressed mail to that specific address.
  700. Note:  For your own net, add the following line, so that unlisted nodes
  701. using Yournet/65535 may get a response from you:
  702.  
  703. @ Yournet/65535 Hold Arc
  704.  
  705.         Personally, with all of the conflicts in how various software
  706.         determines net/node addressing, I don't recommend new nodes
  707.         using a -1/-1 address.  For new nodes requesting an address, I
  708.         recommend something like Yournet/999 or Yournet/9999
  709.  
  710.  
  711.   Defined nodes take first precedence, and if a node is undefined,
  712.   Routing information is then used.
  713.  
  714. -----------------------------------------------------------------------
  715. Send <Flavor> <Destination_Address> Nodes
  716. <Currently under construction>
  717.  
  718. This is the default list of nodes you wish to send to. Example:
  719.  
  720. Send Hold 1:103/all 102/all
  721.  
  722.        In this example, unless a node in Net 102 or 103 is previously
  723. defined, it will generate a hold attach for nodes that fit into this
  724. definition.  I cannot emphasize enough the 'sequence' of operations in
  725. routing, and will show you an example that will NOT work.
  726.  
  727. Example:
  728.  
  729. Route Crash 1:103/100 103/all
  730. Send Hold 1:103/all 102/all
  731.  
  732.         In this example, 103/100 has been defined to handle all
  733. undefined nodes in net 103.  The line immediately after that defines all
  734. nodes with HOLD status.  Since the nodes in net 103 are already
  735. previously defined, the entry to Send to net 103 on hold status is
  736. ignored.
  737.  
  738.  
  739. -----------------------------------------------------------------------
  740. Route <Flavor>  <Destination_Address> <Nodes> .. .. ..
  741.  
  742.         This commandline option will define how netmail destine to nodes
  743.         not defined in EE.CFG  will be routed.  All routing is setup in
  744.         priority of the first listed address.  Example:
  745.  
  746.  
  747. Route Crash 1:103/100 1:all 2:all 3:all 4:all
  748. Route Crash 1:103/501 1:all
  749.  
  750.         In this case, mail destined to anyone in Zone 1 would be routed
  751.         to 103/100, because it matches with the first listed address.
  752.         The only accepted routing flavors in the route statement are
  753.         CRASH NORMAL and DIRECT.
  754.  
  755.         Note:  if the address that you are routing to is not defined in
  756.         the nodes section of EE.CFG, the first compressor listed will be
  757.         used to compress this mail.  By default, the first definition
  758.         should be ARC, using Old compression technique.  Although ARC
  759.         can be totally removed, it's not recommended.
  760.  
  761.  
  762. The following is the 'thought process' of my current routing section to
  763. better define how this system 'thinks'.  Think of the routing scheme as
  764. a thought process, and where the first match occurs, action is taken.
  765.  
  766. Route Crash 1:103/158 158 69:all
  767.  
  768. Send all mail destined to Zone 69 to 1:103/158
  769.  
  770. Route HOLD 1:116/1000 3000
  771. Route Echomail previously defined as 'NORMAL' destined to 116/3000 to
  772. 1:116/1000
  773.  
  774. Route Hold 1:157/2 157/3
  775. Route all mail destined to 157/3 to 157/2
  776.  
  777. Route HOLD 1:282/44 22
  778. Route HOLD 1:3807/1 380/5
  779. Route Hold 1:10200/2 1:103/210
  780. Route Crash 1:103/350 1:103/300 307 355
  781. Hub route these addresses.
  782.  
  783.  
  784. Route crash 1:103/100 0 106 115 121 122 125 130 134 136 143 145 148 150 155 156 158 160 165
  785. Route crash 1:103/100 310 315 328 320 332 335 338 340 345 507 602
  786. Route Crash 1:103/100 900 901 908 910 912 913 916 917 918 921 925 929 930 935
  787. Route Crash 1:103/100 280/all 374/all 362/all 991/all 112/all 212/all 379/all 33/all
  788. These too.
  789.  
  790. Route Crash 1:103/227 0/0
  791. What can I say, he's the worst offender... <g>
  792.  
  793. Route Crash 1:109/25 109/all
  794. Route all mail destined to net 109 to The 109/25
  795.  
  796. Route HOLD  1:202/701 202/all 2:all 3:all
  797. A bit more on this part.
  798.  
  799. Route Crash 1:103/229 329
  800. Route Crash 1:103/501 10/all 1/All 102/all 151/all 13/13
  801. Route Crash 1:103/501 4:all 5:all 6:all
  802. Route Hold 32767/1 1:103/all
  803.  
  804. For test purposes, I unpack all other mail at a time when I have a
  805. chance to look at it.
  806.  
  807. Route Crash 1:32000/1 1:all
  808.  
  809. Everything else pack to a non-existant address to go no where real fast.
  810. <For testing purposes>.
  811.  
  812.  
  813.  
  814. ------------------------------------------------------------------------------
  815. Other tossers may be implemented in the shell environment, as all of this
  816. is fully configurable.  This section will describe how to use the engine
  817. with various processing packages.
  818.  
  819. Using external tossers with the Shell environment:
  820.  
  821. QMail Copywrite (c) Greg Dawson (1988,1989) & George Peace.
  822.  
  823.         When you operate with Qmail, take the following into consideration,
  824.     to assure your downlinks a smooth transition:
  825.     Turn Max_Msgs off, and instead, configure the engine to the largest
  826.     total number of packets to process in one pass of QM Toss SCAN -z.
  827.     Comment out the Routing file in QM.CFG and define your routing in
  828.     EE.CFG.  If you are gating, you may need to have a gate route
  829.     statement, but it's only NOARC NORMAL route statement should be in
  830.     the file, to assure that Qmail does no packing of outbound .OUT
  831.     files.  Also, for scheduling purposes, EE_SKUD will do the job in
  832.     the near future.  I hadn't planned on it, but found that several
  833.     Coordinators use Scheduling Exclusively.  EE_SKUD will make up for
  834.     the weaknesses in the routing of the other Echomail and default
  835.     routing of outbound .out files.  Also, refer to SAMPLE.CFG that comes
  836.     with this package for efficient operation.  I let EE unpack all
  837.     archived mail, and Qmail does not see archived mail in any inbound
  838.     directory, using the following command line in QM.CFG
  839.  
  840.         NETFILE NOARCMAIL j:\line1\inp1
  841.  
  842.     Using this method, Qmail will only find .pkt files, and will leave
  843.     Arcmail alone.  The intention behind this method is so that Echomail
  844.     Engine can tell whether or not it's 'safe' to unpack and process
  845.     mail.  'Safe' is the defined ammount of drive space required to
  846.     unpack incomming mail to the current operating directory.
  847.  
  848.     Suggestions are welcomed in improving of this process.
  849.  
  850.  
  851. Qecho <Copywrite Quickbbs Group>
  852.  
  853.         When using Qecho, use oMMM bundling to process mail. <-Z instead
  854.         of -A>.  Recommended parameters for tossing & Scanning are as
  855.         follows:
  856.  
  857.         Tosser_Cmd Qecho.EXE -t -u -p -z
  858.         Scanner_Cmd Qecho.EXE -e -p -z
  859.  
  860.         Also, in Qecho.Ctl, make sure that OutboundPath points to the
  861.         same directory as Echomail Engine.
  862.  
  863. ---
  864.  
  865. For additional support with various implementations,
  866. request from your uplink EE_SUPPORT for access to the conference
  867. dedicated to developement and support of the Engine.
  868. Although the product is not yet fully released, all ideas will be
  869. considered, trashed, or discussed, in that order.
  870.  
  871.  
  872. Joe Jared
  873. 1:103/200@Fidonet.Org
  874.